Skip to content

Conversation

@andrewleech
Copy link

Summary

This PR improves the README.md documentation by:

  • Adding a comprehensive step-by-step guide for updating MCU series to new vendor versions
  • Documenting the vendor/work branch workflow with concrete examples
  • Updating the title and introduction to include all currently supported MCU series (G0, H5, L1, N6, WL were previously missing)

The new "Updating to a new vendor version" section covers:

  • Cloning/fetching upstream STM32Cube repositories
  • Using fetch_from_upstream.sh to import vendor code
  • Proper commit message format and tagging conventions
  • Creating work branches and rebasing MicroPython patches
  • Pushing and creating pull requests

This makes the workflow more accessible to contributors and reduces the risk of manual errors when updating vendor libraries.

Testing

Documentation-only change. The instructions have been validated through successful execution of the WB v1.23.0 update (see PR #27).

Trade-offs and Alternatives

N/A - pure documentation improvement with no code changes.

@andrewleech andrewleech force-pushed the readme-workflow-improvements branch 6 times, most recently from 29033f6 to 0b14eec Compare October 14, 2025 01:43
Copy link
Member

@dpgeorge dpgeorge left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, this looks good!

This adds a step-by-step guide for updating MCU series to new vendor
versions, making the vendor/work branch workflow more accessible.

The new section covers:
- Cloning/fetching upstream STM32Cube repositories.
- Using `fetch_from_upstream.sh` to import vendor code.
- Proper commit message format (tags are created by maintainers).
- Creating work branches and rebasing MicroPython patches.
- Pushing and creating pull requests.
@dpgeorge dpgeorge force-pushed the readme-workflow-improvements branch from 0b14eec to 8d9e35e Compare October 15, 2025 00:12
@dpgeorge dpgeorge merged commit 8d9e35e into micropython:vendor Oct 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants